home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 3 / Your Choice Software Collection 3.iso / dos / colprint / colprint.doc next >
Text File  |  1994-06-26  |  15KB  |  311 lines
  1.                     ColPrint version 2.1  (Column Printer)
  2.  
  3.                                June 25, 1994
  4.  
  5.                   Copyright (C) 1992-1994 by Thomas M. Roddy
  6.                             All Rights Reserved.
  7.  
  8.  
  9. Introduction:
  10.  
  11. ColPrint reformats a text file into two or three 80 line columns for printing
  12. on standard 8 1/2" x 11" paper. ColPrint removes excessive blank lines and
  13. original form feeds and uses a small font to fit up to three or four
  14. times as much text on a page compared to regular printing. Many printers,
  15. from 9 pin dot matrix to laser printers, are supported. Several command line
  16. options allow you to control the actions of ColPrint.
  17.  
  18. The shareware version of ColPrint is restricted in one way. To encourage
  19. registration, it will only process the first 5000 or so lines of a file. This
  20. should be adequate to test the usefulness of the program. Please register
  21. if you find ColPrint useful. You will mailed the latest version of the program
  22. without the shareware notice and with the 5000 line restriction removed.
  23.  
  24. Rap is a word wrap program which is included in this distribution, but has a
  25. registration fee separate from ColPrint. Rap is useful for reformatting text
  26. files into specific line lengths in order to print the text files into
  27. columns. See RAP.DOC for more information.
  28.  
  29. ColPrint 2.1 is the same as ColPrint 2.0, but it is being rereleased with a
  30. new version of Rap and modifications to the documentation file and order form.
  31.  
  32.  
  33. License and distribution information:
  34.  
  35. ColPrint is shareware. It is not public domain or free software. An order form
  36. is enclosed in the file named ORDER.FRM.  After trying it out for 14 days, if
  37. you like it and want to continue using ColPrint, please register by sending the
  38. registration fee (located in ORDER.FRM) with your name and address along with
  39. any comments or questions to the address listed. A companion word wrap program,
  40. Rap which is included in this distribution, must also be registered after 14
  41. days of use according to the instructions in ORDER.FRM.
  42.  
  43. You may NOT alter the code nor may you sell this program or any of its
  44. associated data files for any price.  You may charge a reasonable copy
  45. fee of not more than US$10 when distributing it to others as long as you
  46. clearly stipulate that ColPrint and Rap must be registered with its author
  47. if it is used beyond the trial period. Every copy of the ZIP distribution
  48. file must contain all of the files listed below.
  49.  
  50. You may (and are encouraged to) distribute the shareware version of ColPrint.
  51. Under no circumstances may you distribute a registered version of ColPrint
  52. to others.
  53.  
  54.  
  55. Disclaimer:
  56.  
  57. The author makes no claims or guarantees about the use of ColPrint and will
  58. not be responsible for any loss, including data or profits, due its use
  59. or misuse.
  60.  
  61.  
  62. Compatibility:
  63.  
  64. There is no guarantee that ColPrint has been tested on your specific printer,
  65. but I believe it should work on all of the following printers or printers
  66. compatible with the following: Panasonic KX-P1124, All Epson dot matrix 9
  67. and 24 pin printers (LQ series, FX series, etc.), HP laser printers, HP
  68. DeskJet printer, IBM Proprinter X24, and NEC P2200XE. Please let me know if
  69. you can not get ColPrint to work on one of the above listed printers. I'm
  70. sure there are others that ColPrint will work with. Try it! Many dot matrix
  71. printers are compatible with one of the above.
  72.  
  73.  
  74. Files in distribution:
  75.  
  76.  COLPRINT.EXE  -   Program which prints a document using two columns
  77.  COLPRINT.DOC  -   This file - Documentation for ColPrint
  78.  RAP.EXE       -   Program which reformats text files to specified line lengths
  79.  RAP.DOC       -   Documentation for Rap
  80.  PR1COL.BAT    -   Batch file for printing one column documents
  81.  PR2COL.BAT    -   Batch file for printing two column documents
  82.  PR3COL.BAT    -   Batch file for printing three column documents
  83.  ORDER.FRM     -   Printable order form for registering the programs
  84.  FILE_ID.DIZ   -   Short description of ColPrint
  85.  
  86. Product description:
  87.  
  88. ColPrint is my answer to the overwhelming amounts of paper that piles up
  89. from printing various large document files.  If you prefer to read them on
  90. paper rather than on the PC, as I do, and you want to save a few trees, I
  91. think you will find this program useful.
  92.  
  93. ColPrint can print the same text on a fraction of the amount of paper normally
  94. required.  It is not unusual to reduce a 100 page document to 30 pages (or
  95. 15 if you use both sides of the paper).
  96.  
  97. ColPrint was initially developed to take advantage of the 20 character per
  98. inch mode (pitch) of many 24 pin dot matrix printers, HP DeskJet, and laser
  99. printers. This mode permits 160 characters per line to be printed which fits
  100. two 80 character columns nicely on a single page with no space between the
  101. columns.
  102.  
  103. NOTE: Not all printers support 20 characters per inch (cpi) which is
  104. equivalent to 160 characters per line, but most support around 17 cpi
  105. (137 cpl). If you have a laser printer, check your manual to see if a 20
  106. pitch internal font comes with it.
  107.  
  108. If your printer does not support 20 cpi mode and you have a document which
  109. has 80 character lines then you need to reformat it into shorter lines using
  110. the enclosed word wrap utility, Rap, to print two columns of about 66
  111. characters on a 137 character line. If you prefer three columns, you will
  112. need to use the word wrap utility first to reformat to about 42 character
  113. lines. Otherwise the lines will be truncated when printed using ColPrint.
  114.  
  115. Rap is a word wrap program which is distributed with this program, but its
  116. use beyond 14 days requires a separate registration fee.
  117.  
  118. By default, ColPrint Reads an ASCII file, removes form feed (advances to
  119. new page) characters, removes blank lines (except for one) which occur
  120. between text, sets printer for compressed print, 8 lines per inch (80 lines
  121. per page), either 137 or 160 characters per line depending on printer type,
  122. and formats the text into columns for output. The original document remains
  123. unchanged. You can still print it out in the traditional way. ColPrint makes
  124. a guess regarding the maximum pitch of your printer. If that guess is wrong,
  125. specify a smaller line length on the command line (/L) to create smaller
  126. widths of columns.
  127.  
  128. Optionally, you can print out just the odd or just the even pages thereby
  129. allowing you to print on both sides of the paper. For example, you would
  130. print all the odd pages, flip the paper over and feed it back into the
  131. printer. Then print all the even pages. This allows you to minimize your
  132. use of paper.
  133.  
  134. I usually send the output to a file and then use DOS's print command to
  135. send it to the printer. This way the print job is queued up and I can still
  136. use my computer for other things. There is no such print spooling built
  137. into ColPrint so the computer remains occupied until the printing is complete
  138. if you send it directly to the printer (the default action).
  139.  
  140. There are several options that you can give to control the formatting of the
  141. text. For example, you can specify a left margin so that there will be space
  142. on the left side of the paper which could be hole punched for a binder. Just
  143. make sure that you shorten the line length and possibly reformat your file
  144. using Rap in order to make room for the margin. Also, you can set the number
  145. of columns, column width, and total line length of the output file (includes
  146. all columns). You can specify which type of printer you are using and whether
  147. to print just odd or even pages.
  148.  
  149. Remember, ColPrint will not automatically wrap lines (to the next line) that
  150. are longer than the column width. The lines will be truncated. Please use
  151. Rap to format the file into shorter line lengths if necessary. Then print
  152. the file using ColPrint.
  153.  
  154. Enclosed are a few batch files to help automate the reformatting of line
  155. lengths with Rap followed by the reformatting into columns by ColPrint.
  156. Consult your DOS manual if you don't understand the batch files.
  157.  
  158.  
  159. Usage: ColPrint InFile [OutFile] [/O] [/E] [/Tn] [/Cn] [/Mn] [/Wn] [/Ln] [/Pn]
  160.    where InputFile  = File to be printed
  161.          OutputFile = Destination File or printer device such as
  162.                       LPT1 (default), LPT2, COM1, or COM2,
  163.          /O = Print Odd numbered pages only
  164.          /E = Print Even numbered pages only
  165.          /Tn = Use printer commands for printer type n, where n is one of:
  166.            2  = Epson 20 cpi compatible printer - 160 chars per line (default)
  167.            1  = Epson 17 cpi compatible printer - 137 chars per line
  168.            I  = IBM Proprinter X24 compatible printer - 137 chars per line
  169.            L  = HP LaserJet compatible printer - 160 chars per line
  170.            D  = HP DeskJet compatible printer  - 160 chars per line
  171.            N  = NEC P2200XE compatible printer - 160 chars per line
  172.          /Mn = Left margin of n spaces (default = 0)
  173.          /Cn = Print using n columns (1, 2 (default), or 3)
  174.          /Ln = Total line length of output is n characters (default depends
  175.                on printer type; either 160 or 137)
  176.          /Wn = Width of each column (default = Line length/Columns)
  177.          /R  = Do NOT issue a reset to the printer before printing
  178.          /B  = Do NOT skip multiple blank lines (i.e. Print all input lines)
  179.          /G  = Use graphics character set (works on printer types 1 and 2 only)
  180.          /Pn = Pitch (characters per inch) of n. For lasers and DeskJets ONLY.
  181.  
  182. / or - are both supported for specifying options.
  183. Upper case and lower case option characters are equivalent.
  184.  
  185.  
  186. Examples:
  187.  
  188.     ColPrint TEXTFILE.TXT COM1
  189.           will print to the first serial port. Other default options are
  190.           assumed: All pages, 2 columns, 20 cpi printer, 160 line length, 80
  191.           character columns (160 characters per line / 2 columns), no left
  192.           margin.
  193.  
  194.  
  195.     ColPrint TEXTFILE.TXT LPT2
  196.           will print to the second parallel port.
  197.  
  198.     ColPrint TEXTFILE.TXT TEXTFILE.COL
  199.           will write to a file named TEXTFILE.COL (You could then
  200.           edit it or print it using your favorite print spooler).
  201.  
  202.     ColPrint TEXTFILE.TXT TEXTFILE.COL /E
  203.           will write the even pages (after formatting of TEXTFILE.TXT)
  204.           to TEXTFILE.COL.
  205.  
  206.     ColPrint TEXTFILE.TXT /TL /L150 /C3 /M10
  207.           will write to LPT1 all pages in three columns. The line length
  208.           is set to 140 characters, so columns will be 50 characters wide
  209.           each (150 characters / 3 columns). A 10 character margin on the
  210.           left side is specified. The printer type specified is the HP
  211.           laser printer.
  212.  
  213. If you want to specify a different font or other setting to the printer, then
  214. make sure you use the /R switch. Otherwise, ColPrint will issue the "reset"
  215. command before printing which will use the default "power on" settings of
  216. the printer.
  217.  
  218. The /P option is to specify a different pitch and is only valid if the printer
  219. is of type L (Laser) or D (DeskJet). The default for these printers is 20
  220. characters per inch. You may want to change it to a slightly larger value
  221. if you have the internal fonts for that pitch.  ColPrint does not come with
  222. any fonts. Check your printer's manual to see if you have a 20 cpi pitch
  223. or higher.
  224.  
  225. Most word processor programs save their files in a proprietary format with
  226. control characters. If the text file is not in ASCII format, you must convert
  227. it to ASCII. Most word processors allow you to do this. Alternatively, you
  228. can use the free utility program from PC Magazine called PCMCVT.COM to strip
  229. the control characters out of the proprietary formatted word processing
  230. documents.
  231.  
  232. Specifying one column is a valid option. You may find this useful after
  233. using the word wrap program to reformat the input file to 137 or 160
  234. character lines and then using ColPrint to print it out in one column -
  235. utilizing the compressed printing.
  236.  
  237. If the document you are printing has box drawing characters, then you must
  238. specify the /G option in order for the printer to use the correct
  239. character set. Of course there is a trade off. When using the graphics
  240. character set, your document should not contain any italicized characters
  241. or else they will print incorrectly. This option only works with the Epson
  242. compatible dot matrix printers (both type 1 and 2 as defined above). I
  243. believe the IBM printer will use the graphics character set by default.
  244.  
  245. COLPRINT.EXE and RAP.EXE should be placed in a directory which is in your
  246. search PATH so that you can run the programs from within other directories.
  247.  
  248.  
  249. ColPrint environment variable:
  250.  
  251. You can set an environment variable named "ColPrint" equal to the options
  252. that you want to be in effect each time ColPrint is run. ColPrint will read
  253. the environment variable prior to the command line option, so you can
  254. over ride an option in the ColPrint environment variable by specifying a
  255. different value for that option on the command line.
  256.  
  257. For example, in your AUTOEXEC.BAT, you could have this line:
  258. SET COLPRINT=/C3 /TL
  259.  
  260. so that every time you run ColPrint, it will be set up for 3 columns and a
  261. laser printer type.
  262.  
  263. IMPORTANT: Make sure there are no spaces on either side of the equal sign
  264. when defining the COLPRINT variable.
  265.  
  266. Input and output files will not be overridden, so whichever method (variable
  267. or command line) gives file names, they will be used. Since the environament
  268. variable is read first, if it specifies files, than the command line
  269. specified files are ignored.
  270.  
  271.  
  272. Return value:
  273.  
  274. ColPrint returns a value of 0 on successful completion or a 1 on error.
  275. This information is useful if you are calling ColPrint from a batch file
  276. (see ERRORLEVEL) or another program.
  277.  
  278.  
  279. Miscellaneous information:
  280.  
  281. Output files are frequently larger than the size of original file due to
  282. the additional whitespace (spaces) between columns.
  283.  
  284. ColPrint does not support reading from standard input or writing to
  285. the standard output device. In other words, you can not pipe data into
  286. or out of ColPrint using the DOS pipe symbol, |. You must specify an input
  287. file for ColPrint to use. If no output file is specified, then the output
  288. is written to LPT1 (the first parallel port).
  289.  
  290. Warning: you are not legally allowed to modify many copyrighted software
  291. manuals. This program should be used on your own personal files or with the
  292. permission of the document's author.
  293.  
  294. If you are interested in having ColPrint customized for a fee, contact the
  295. author at the address below.
  296.  
  297. The official distribution site for ColPrint is the Programmers Corner BBS in
  298. Columbia, Maryland (410)995-6873. You can be sure of having the latest
  299. version of ColPrint if you download it from there. CompuServe will have it
  300. soon after the Programmers Corner. I can also be reached on the Programmers
  301. Corner BBS for technical support by sending a message to Tom Roddy.
  302.  
  303. The author can also be contacted by US mail or CompuServe:
  304.  
  305.  Thomas M. Roddy              CompuServe ID:  73730,3304
  306.  7158 Harp String             Internet: 73730.3304@compuserve.com
  307.  Columbia, MD  21045
  308.  
  309.  
  310. Trademarks are the property of their respective owners.
  311.